Documentation for new an1 and simplify options
authorparkrrrr <parkrrrr@f51c46e8-681c-474f-0cfe-069cfd0219fb>
Sun, 13 Nov 2005 17:20:19 +0000 (17:20 +0000)
committerparkrrrr <parkrrrr@f51c46e8-681c-474f-0cfe-069cfd0219fb>
Sun, 13 Nov 2005 17:20:19 +0000 (17:20 +0000)
gpsbabel/readme.xml

index 6711e11108cfc028a92285dd39b9172b07c4fa1f..78fc777b6540195195a8937b093df74b1d08f0a3 100644 (file)
@@ -213,9 +213,12 @@ file.  To find the name of a specific symbol in Street Atlas, let the
 mouse pointer hover over it for a few seconds and the name will be
 displayed.</para>
       <para>The "color" option allows you to specify the color for
-line data.  It accepts color names of the form "#FF0000" (red) or any
+line or mapnote data.  It accepts color names of the form "#FF0000" (red) or any
 of the 16 common color names from the Cascading Style Sheets
 specification.i</para>
+      <para>The "wpt_type" option specifies how to represent point data
+in the draw file.  Valid waypoint types are "marker", "text", and "mapnote".
+The default is "marker". </para> 
       <para>The "zoom" option specifies at what zoom level Street
 Atlas will begin showing reduced versions of your symbols. The default
 is 10.  Setting zoom to 0 will disable this feature.  Setting it to
@@ -1787,20 +1790,30 @@ mentioned above. Contributed to GPSBabel by Alex Mottram.</para>
          <title> SIMPLIFY</title>
          <para> The Simplify filter is used to simplify routes and
          tracks for use with formats that limit the number of points
-         they can contain.  The filter takes one required parameter,
-         which is the maximum number of points a route may contain.
-         It attempts to remove points from each route until the number
-         of points is at or below the given maximum, while also
-         attempting to preserve the shape of the original route as
-         much as possible.  </para>
+         they can contain or just to reduce the complexity of a route.</para>
+         <para>The Simplify filter attempts to remove points from each 
+         route until the number of points or the error is within the given 
+         bounds, while also attempting to preserve the shape of the original 
+         route as much as possible.  </para>
+         <para>You must specify either the "count" option or the "error" option.
+         The count option requires a number, which is the maximum number
+         of points that will appear in the simplified track.  The error 
+         option takes a distance, optionally followed by an 'm' for miles or
+         a 'k' for kilometers.  That distance specifies the maximum error;
+         how that error is determined depends on the simplification method,
+         described next.</para>
+         <para>You may also specify the method by which the filter chooses
+         which points to remove.  The options are "length", which tries to
+         remove points that have the smallest effect on the overall length
+         of the route, or "crosstrack", which tries to remove points that 
+         have the smallest overall effect on the shape of the route.  The
+         default, if you don't specify either option, is "crosstrack". </para>
          <para> The quality of the results will vary depending on the
          density of points in the original route and the length of the
-         original route.
-</para>
+         original route.</para>
          <para> For example, suppose you have a route from Street
          Atlas 2003 that you wish to use with a Magellan GPS receiver
-         that only supports up to 50 points in a route:
-</para>
+         that only supports up to 50 points in a route:</para>
          <screen format="linespecific">gpsbabel -r -i saroute -f RoadTrip.anr \
    -x simplify,count=50 \
    -o magellan  -F grocery.rte